mdblog 0.22.0

static site generator from markdown files.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

created: 2018-04-22T12:31:00+08:00
tags: [tutorial]

when you installed [`mdblog`][],
you can use its subcommand `init` to initialize a new blog project.

[`mdblog`]: https://crates.io/crates/mdblog


## init blog project

```
mdblog init myblog
```

this command will create a new directory named `myblog` in the current directory,
and initialize its directory layout as:

```
myblog
├── config.toml
├── media/
├── posts/
└── _themes/
```

* `config.toml`: blog project config file
* `media`:  blog project media directory
* `posts`: blog project markdown posts directory
* `_themes`: blog project themes directory

## run subcommand

every mdblog subcommand except `init` should be run in the top blog project directory.

```
cd myblog
# mdblog subcommand
```

`config.toml` must be existed in the top blog project directory.

## check blog project


now you can run `serve` command in the blog project directory
to check the web pages:

```
mdblog serve
```

the web browser will be automatic opened at the blog index page.